package xyz.heyaoshare.common.entity.bo;

import io.swagger.v3.oas.annotations.media.Schema;
import lombok.AllArgsConstructor;
import lombok.Data;

import java.io.Serial;
import java.io.Serializable;
import java.util.Collections;
import java.util.List;

/**
 * 分页数据返回类
 * @author YueHe
 * @version 0.0.1
 * @since 2025/6/25 上午10:21
 */
@Data
@AllArgsConstructor
public class ResultPage<P> implements Serializable {

    @Serial
    private static final long serialVersionUID = 1L;

    @Schema(description = "总条数")
    private long total;

    @Schema(description = "列表数据")
    private List<P> list;

    private ResultPage() {
    }

    /**
     * 返回一个空的ResultPage对象
     *
     * @param <P> ResultPage中元素的类型
     * @return 一个空的ResultPage对象
     */
    public static <P> ResultPage<P> empty() {
        return new ResultPage<>(0L, Collections.emptyList());
    }

    /**
     * 根据给定的总数和列表，生成一个结果页面对象。
     *
     * @param <P> 列表元素的类型
     * @param total 结果集中的总记录数
     * @param list  结果集中的数据列表
     * @return 返回包含总记录数和数据列表的结果页面对象
     */
    public static <P> ResultPage<P> result(long total, List<P> list) {
        return new ResultPage<>(total, list);
    }

}